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ABSTRACT 

This manual is intended as a reference handbook for 
use in writing instructional dialogs on the Sigma-7 computer. The 
concern is to give concise information which one would need to write 
and debug dialogs on this system. Metasymbol, the macro-assembly 
program for the Sigma-7, is described. Definitions of terminology, 
legal forms descriptions of current commands, and examples are given. 
Basic, introductory information on getting dialogs into the computer, 
assembling and debugging them, and in preparing them for student use, 
makes up most of this manual. (RB) 
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INTRODUCTION 
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e Reader 


This manual is intended to be used as a reference handbook by the 
person writing instructional dialogs using the Sigma-7, Another ’ 
document, called "Teaching Conversations with the XDS Sigma-7 z 
System Description," presents an overview of the system as a whole and 
presents a better introduction to the subject than this manual. Here 
our concern is to make a concise presentation of the information a 
person will need while learning to write and debug dialogs. 

The first chapter contains the miles on legal forms and some defini- 
tions of terminology. Chapter 2 contains descriptions of each of the 
* commands currently available, with examples of their use. Chapter 3 
contains introductory material on the programs and ^routines used in 
getting dialogs into the computer, assembling and debugging them, and 
preparing them for student use. This information is introductory and 
tutorial in intent and does not by any means replace the need for the 
more complete descriptions in the appropriate XDS manuals. 




The system described here continues to change and grow as its use 
expands. If you are a user of this system and not just an observer, 
be sure to fill out the form on the last page so that you can be kept 
up-'to-date on improvements as they occur. 
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CUATTER 1 
WRITING DIALOGS 

•An instructional dialog using the commands defined here is actually 
a program written for Metasymbol , the macro-assembly program for the 
Sigma- 7. The dialog must therefore adhere to Metasymbol conventions 
for formats and the special use of symbols. In addition , seme con- 
ventions have been established within the dialog system itself . 

These topics are the subject of this chapter. 
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1. Program Format 

The first statement of the program must be 



SYSTEM 



DIALOG 



The SYSTEM command (preceded by at least one space) directs the 
assembler to select a file containing the commands that are to be valid 
during this assembly; DIALOG is the name of the file containing the 
commands described here. . 

After the SYSTEM statement but before the first executable command, 
the program must have one or the other of these statements: 



NAME 

START 



arg 



END 

\ 

This indicates to Met^ 
process. The argument] 
routine is to- be used j 
for an ID if the rest^ 
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of the introductory 
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Either of these commands will cause the system to introduce some 
initialising procedures into your program, which are to be executed 



2. Line Format 
Each line may contain | 
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ftmands defined here is actually 


bcforo your first command. In addition, NAME assigns a name (the 
argument you supply , of not more than four characters enclosed in 
quotes) to your program. This simply individualizes the program. 

It is particularly valuable when student responses are saved on disk 


1 macro-assembly program for the 


for later reference; the name of the program individualizes these 


adhere to Metasymbol conventions 


records so that there is no possibility of getting them confused with 


Lmbols. In addition, some con- 


those of other instructional programs. 


p the dialog system itself. 




| chapter. 


The last statement of the program must be 


ist be 


END DIALOGUE 

\ 

This indicates to Metasymbol that this xs the last statement it is to 
process. The argument "DIALOGUE" indicates that a standard beginning 
routine is to- be used when the program is run. (It asks the student 


sast one space) directs the 


for an ID if the restart facility is used somewhere in the program. ) 


j the commands that are to be valid 


Other arguments are possible: if the argument is the label of a state- 


lame of the file containing the 


ment in the program, it is understood that this is the first statement 
that will be executed when the program runs. This short-circuits all 
of the introductory and initializing instructions and should be used 


i the first executable command. 


only with caution and a full understanding of the implications . 


sr of these statements: 


. . - Additional information about program format will bd found in Chapter 3 
in the sections on segmenting and overlaying; these will be of interest 
to the author of very large programs. 


the system to introduce some 


2._ Line_Format 


>gram, which are to be executed 


Each line aay contain four fields, separated by one or more blanks: 
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LABEL 



COMMAND 



ARGUMENT 



COMMENT 



There are thus no restr 



Because blanks are the delimiters of the fields, it is clear that 
blanks are never allowed within the fields (except within character 
strings, as described below) . The label field may be omitted; if it 
is present, it must begin in the first position on the line. If 
that position is blank, it is assumed that there is no label and the 
command field follows immediately . Labels are attached to statements 
so that they can be referred to elsewhere in the program; label 
formats are described below. The next field is the command; either 
one of the commands listed here or one of those defined in the 
Symbol/Metasymbol manual. The command field must be present; it is 
the command which indicates what it is that you want the computer to 
do. The third field is the argument. The parameters necessary to 
complete the meaning of the statement are entered here, usually 
separated by commas — again, without blanks, since a blank indicates 
the end of the field. The fourth field is for comments and is 
ignored by the assembly program. (If the command requires no argument , 
then everything past the cossaand field is ignored. The line (if it 
is entered from a terminal) can be ended at any point by a carriage 
return* 

There is a single exception to all of this* If the first character 
on the line is an asterisk, the entire line is ignored* Such lines 
are considered "comments" and can be of value in making your pregram 
clearer to read and understand* 
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There are thus no restrictions about what information can appear 
in which column or position on the line. Nevertheless, it makes a 
program easier to read if some such conventions are adhered to; perhaps, 
label in columns 1-8, command in columns 10-19, argument in columns 
20-39, comments beginning in 40. Tab stops (see Chapter 3 for using 
tab stops) make it easier to adhere to these conventions when entering 
the program from a terminal. 

3. Character string constants 

A large part of any instructional dialog program is made up of strings 
of characters which are to be typed for the student to read or com- 
pare with student responses. Such strings must be enclosed in single 
quotes. They may contain any characters; they are thus an exception 
to the "no blank" rule. If you want to place a single quote inside such 
a string, you must use two single quotes. A few examples may help: 

• • 

•Y0U"RE RIGHT!' 

4 . Labels and Location Symbols . 

The programmer may assign names to instructions, constants, and 
variable storage locations so that he can refer to them. The most 
common way of attaching such symbols to locations is by the use of a 
label in the first field of a statement. Symbolic names must also be 
attached to parameter storage. There are special commands (DEFINE, 
COUNTER; STRING, DEFNUM, etc.) described below which do this without 
using Idle label field. The label or location symbol may consist of 










CHAPTER 2 



• V* 

any combination of letters and digits except all digits. (The advanced 
student should be cautioned against using any labels beginning with 
character since this is used internally in labels in the macro 
definitions, and so might lead to conflicts.) 

One location symbol used in the program may be of interest to the 
user. The input buffer, containing the most recent message typed 
by the student is called #XN and may be referred to by that name. 

It is defined by the system and must not be defined by the user. 
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CHAPTER 2 

DESCRIPTION OF COMMANDS 

This chapter contains descriptions of all the commands currently 
available* They sure arranged by functions; however, the index on 
the following page lists them in alphabetical order. 

In general, the descriptions will have the following format: 

NAME (SYN0NYM1, SYN0NYM2 . . . ) 

Description of the logical function of the command* 

When several alternative forms exist, each will be 
described* 

Example 1: 

description of function of example 1 
Example 2: 

description of function of example 2 

Examples are given of each form of a command, when there are multiple 
forms, except where the meaning appears too obvious to warrant it. 

If terms used in the description are unfamiliar to you, you may find 
them defined above in Chapter 1* 

1* Displaying Information 

Commands for displaying information to the student* 

WRITE (PRINT, ECRIVBZ, SHOW, TYPE) 

ODT V • 

SKIP (SAOTEZ) 

‘ GRAPH : - 
PLOT 

NUMOOT (OUTNUM) 

NUMWRXTE (WRITNUM) 

OOTABLE 
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2, Acceptin g Information 

Commands for accepting information from the student 

INPUT (ACCEPT, ACCEPTEZ) 

INBELL 



3- Analyzing Input 

Co m ma n ds for analyzing student input 

IF (SI) 

IFONLY 

IFNOT 

IF YES 

IFNULL 

IFBEFORE 

IFAFTER (IFNEXT) 

IFNEXTO (IFAFTERO) 

IFTERMS 

ALLWRONG 

NOTERMS 

IFKE 

IFPE 

IFFILTH 

TO (OTHER# AUTRE# B# JUMP) 



4, Manipulating Strings 
Commands to manipulate strings 

NOBLANK 

‘DELETE (REMOVE) 
OELETEALL 

REPLACE (SUB# SUBsFOR) 

SUBALL 

ADDAST 

MOVE (MOVEZ) 

PTRMOVE 

APPEND 



5> Manipulating Numbers 

Commands to manipulate numbers 

NUMBER 

SCAN 

SCAN* 

IFNUMEX 




IFNOTNUM 

AROUND 

BETWEEN 

RANDOM 

RANDOMR 



6 - Manipulating Counterd 
Commands to manipulate cq 



BUMP (INCREASE] 
DECREASE (SUBlJ 
RESET (ZERO) 
CTARITH 
ADDCOUNT 
CTWRITE 
CTOUT 
SWITCH 



7, Constant and Paramet j 

Directives for constant 

DEFINE (DEFINEj 
COUNTER (COft 
SET 

STRING 
TEXT 
DEFNUM 
STORENUM 
DEFCOMP 
STORECOMP 
DEFTABLE 
STACK 



8, Other Commands 

Other commands and direc| 

SYSTEM 
NAME 
START 
END 

STOP (HALT) 
FINALE (EP3 
ENTRY 

SAVE (KEEP# 
SAVEXD 
FORTRAN 
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Ex. 2 
MES8 
Ex. 3 

Ex. 1 
Ex. 2 



Ex. 1 
Ex. 2 



OUT MES8 

STRING # IS THE SQUAREROOT OF* 

Causes "is the sguareroot of" to be typed. 

OUT MES8 , T3 

Causes a branch to T3 after the string at MES 8 is 
printed. 



PLOT . 
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displ 

Ex. 1 PLOT 



Remember to supply connecting spaces on either the 
WRITE or the following OUT. 



SKIP (SAUTEZ) . Generates one or more blank lines at 
the terminal. The argument indicates the number of 
lines. If no argument is given, one line is skipped.. 

SKIP 5 



Causes five blank lines to appear. 
SKIP 

Causes one blank line. 



GRAPH . Displays data in the. form of a point graph. 
It requires three argu me nts; the location of the 
horizontal displacements (X); the location of the 
vertical displacements (Y) ; the number of points 
to be plotted or the location of that number. All 
numbers will be scaled. Storage of the values is 
“the user's responsibility; STACK may be useful in 
this program. If the values are generated in a 
FORTRAN subroutine (say as an array) r space must 
be reserved in the dialog program. 

GRAPH X,Y,20 

Graph 20 points ,* taking the coordinates from X and 
Y. 

GRAPH TA1,.TA2,CNTR 



Graphs the number of points specified in CNTR, 
taking the coordinates from TAl and TA2. 

At the beginning of a graph is a header giving the 
maximum and minimum values of the two arrays . The 
user cam control scaling on ; : :a ^-series of graphs by 
placing suitable values himself in the two arrays. 
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PLOT . Generates a point plot as specified in the 
arguments. The first argument is the location of 
the values to be plotted; the second argument is the 
number of values or the location of that number. 

All of the values will be scaled and each value will 
represent the amount of horizontal displacement for 
each point. The difference between a plot and a 
graph is that the plot increments the vertical component 
uniformly. A header on a plot gives maximum and minimum 
displacement. 

Ex. 1 PLOT EX, 20 

Will generate a plot of 20 values stored at EX. 



NUMOUT (OUTNUM) . Converts to character type, and 
prints, floating point -numbers. It prints one 
number (specified in the argument) on the same line 
as the last written record (i.e. , no carriage return). 

EX. 1 NUMOUT DISTANCE 

Will print the number stored in DISTANCE, on the 
current line. 



NUMWRITE (WRITENUM) . Converts to character type and 
prints floating point numbers. It starts a new line 
and will print from one to four numbers, as specified 
in the argument (s). 

Ex. 1 *NUMWRITE TIME, ENERGY, MASS 

Starts a new line and prints the three numbers stored 
in TIME, ENERGY, and MASS. 



PUTABLE . Prints the contents of a table. (The 
table could have been defined using DEFTABLE and 
filled using STACK.) The first argument is the 
name of the table? the second argument is the 
number, of values to be printed (or ALL); the third 
(optional) argument specifies how many numbers to 
the line (<5) ; the default is one to a line. If 
the second argument is ALL, as many values will be 
printed as have been stored, if less than all are 
printed, they are the ones at the beginning of the 
table. The second and third arguments may be numbers 
or variable names . 
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Ex. 1 OUTABLB TA,ALL 

Prints all of the entries in the table TA. 



i 






Ex. 2 OUTABLE TA,N 



2, Accepting T 



Prints the first N entries in TA- 
Ex. 3 OUTABLE TA,50, K 

Prints the first 50 entries in TA, K to a line. 



Ex. 1 



Ex. 2 



Ex. 1 
Ex. 2 
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INPUT (ACCEPT, ACCEPTEZ) . Causes a carriage return, 
two line feeds, and a question mark to be executed at 
the student terminal. The computer then waits for the 
student to enter material. The student indicates that 
his message is complete by executing a carriage return. 
The maximum amount of material he can enter is set at 
380 characters but this can easily be extended. The 
line feed key allows multiple lines. 

INPUT 

The author can assume, following execution of this 
command, that student input, up to the carriage return, 
is in the computer and available for inspection. 

Normally, INPUT will be followed by a series of ; IF-type 
statements. Such a sequence may be concluded by an 
OTHER, showing where to go if none of the tests is 
satisfied. ’ 

INPUT # NOECHO * 

If INPUT is followed by the argument *NOECHO*, the 
student's message will not be printed at the terminal. 



INBELL . Sounds a bell, indicating that input is expected 
from the student without a carriage return or line feed. 
Then it waits for the student to enter material. A 
carriage return by the student is taken to mean the end 
of his message. A maximum of 380 characters is accepted. 
No, argument is required. 

INBELL 

INBELL * * NOECHO f 

If the command has the argument 1 NOECHO 1 , the student 
material will not be printed at the terminal. 
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3. Analyzing I nput 

IF (Cl) . Thin command has several forms. The basic one 
calls for two arguments: the first may be a character 

string or the label of a character string; the second 
must be the label of another command. If the character 
string appears anywhere in the student input , the next 
command is taken from the location indicated by the 
second argument. Otherwise, the next command in sequence 
is taken. An alternative form allows the first argument 
to be a series of character strings or adresses of 
character strings (separated by commas and enclosed in 
parentheses) . If any one of them appears in the input 
string, the branch will take place. Another form has a 
third argument, a number: it is the character position 

in the input at which the search is to begin. 

Ex. 1-. IF 'VELOCITY' ,T34 

If the eight character string VELOCITY appears anywhere 
in. the current student input, the next command executed 
will be the one at T34. Otherwise, the next command in 
sequence is taken. 

Ex. 2 IF ( 'COW ' , f HORSE ' , # PIG ' ) ,T34 

If any of the three strings COW, HORSE, or PIG appear 
in the input, the branch will take place. 

Ex. 3 IF 'COW' ,T34 , 7 

The branch will take place in this case only if the 
character string 'COW' appears in the input at or after 
the seventh character the student typed. (This facility 
is not likely to be needed in most dialoges.) 

’A typing error in the student's response, or a misspel- 
ling, may foil the intention of the 'IF' search. The 
teacher will often find it advisable to test a part or 
parts of the desired answer, rather than the whole. 



IFONLY . There must be two arguments: the first a 

character string or the label of a character string, the 
second a location symbol. If the literal string is 
identical with the entire input string, the next command 
is taken from the location indicated by the second argu- 
ment. Otherwise, the next command is taken in sequence . 

Ex. 1 IFONLY • 'VELOCXTY' ,T34 v . 

If the student typed only the eight characters VELOCITY 
and a carriage return, the branch to T34 takes place. 

If he typed more or less than that, it does not. 
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IFNOT. This command is similar in form to IF. However, 
IFNOT branches on the opposite condition, i.e., if a 
match between the argument and the input is not found. 
The form of IF which allows a set of first arguments is 
not possible with IFNOT. 

Ex. 1 IFNOT ’VELOCITY* ,T34 

A branch to T34 will take place only if the student did 
not write "VELOCITY* as part of his statement. 

Ex. 1 IFNOT ( 'COW* , 'HORSE* ) ,T34 

This statement is illegal and not allowed. 



IFYES . Checks for several forms of affirmative reply 
and branches if one is found. 

Ex. 1 IFYES Q3 



IFNULL . Checks for the condition that the student typed 
no characters* at all, other than the carriage return. 

It branches to the location specified in the argument if 
this is the case. The program author can thus check for 
the student who is not trying. 

Ex. 1 IFNULL TRY 

This example will branch to TRY if the student did not 
type anything. 

IFBEFORE . Takes into account the relative position of 
symbols in the response. It refers to the last success- 
ful match in an IF statement, so it must be branched to 
by an IF. It has two arguments, a character string (or 
a label referring to a character string) and the label 
of another command. It specifies that the match between 
the string and the input must be found before the last 
word matched. 

Ex. 1 IF '‘ENERGY 1 , El 

El IFBEFORE .* POTENTIAL * ,E2 

This' sequence tests first to see if the word ENERGY 
appears anywhere in the string and, if it does, then 
tests . to see if the word POTENTIAL appears in the string 
before the word "ENERGY . " 
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IFNEXT (ir Ai'TEK) . Takes into account the relative 
position of symbols in the response. It refers to the 
last successful match in an IF statement , so must be 
branched to by an IF. It has three arguments: a char- 

acter string (or the label of a character string) and 
two laboln of locations in the program. It checks to 
see if the string appears in the input anywhere after 
the last match. . If so, it branches to the location 
specified in the second argument and stores all of the 
characters between the last IF match and the IFNEXT 
match in the location specified in the third argument. 

IF "VELOCITY' ,V1 

• • • 

VI IFNEXT 'M/SEC ' ,V2,VEL 

This sequence will go to V2 if the string "M/SEC" 
appears after "VELOCITY" in the input. It will also 
store anything appearing between "VELOCITY" and "M/SEC" 
in VEL, which must be 'defined. So "THE VELOCITY IS 
FOUR M/SEC" as a response will store "IS FOUR" in VEL. 

After an unsuccessful IFNEXT, any number of IFNEXT f s 
(or IFBEFORE * s ) can be used sequentially, provided no 
successful search is made: 

IF 'VELOCITY 1 ,V1 

• • * 

VI IFNEXT *M/SEC*,V2, VEL 

TFNEXT 'F/SEC 1 ,V2, VEL 

IFNEXTO (IFAFTSRO) . Is similar to IFNEXT. However, 
the character string must exactly match the remaining 
input string. There is no third argument, as no inter- 
. vening characters may appear. 

IF *F=* ,H6 

• » • - 

H6 IFNEXTO ’M*A',H7 

This sequence will transfer to H7 if "M*A" is the entire 
and only string appearing alter "F*". Thus, "F=M*A**2" 
would not make a successful match. 

IFKE . Recognizes various forms of kinetic energy and 
Branches if one is found. 

IFXE , T73 

Branches to T73 if the input contains a correct formula 
for the non-relativistic kinetic energy. 
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IFPE. Recognizes various forms of potential energy and 
' branches if one is found. 

EX. 1 IFPE P77 

Branches to P77 if the input contains a correct formula 
for potential energy. 



IFFILTH. Checks the input string for objectionable 
language. 

EX. 1 IFFILTH NONO 

Branches to the statement labelled NONO if the input 
contains any of several common swear words. 

IFTERMS. And the associated commands ALLWRONG and 
NOTERMS are useful in determining whether all the 
terms in our expression are present, or one or more 
are missing, or have an incorrect sign. 

EX. 1 IFTERMS (’AX**2' ,*A*X+2 , , t A*X**2 # , , ZXf2') , ( , -BX', 

• — B*X * ) , ; ( ’COSTH f , ’COS {TH) * ) , LABEL 

Could be used to check for the expression 

ax 2 - bx + cos(TH) 

If successful, the program would branch to LABEL, if 
not, to the next sequential instruction. 

The argument field of the IFTERMS command includes, 
for each term expected, all the ways in which the 
student can write that term correctly (to the best of 
the author’s ability to anticipate this!) 

All the patterns for one term are grouped in one argument 
so there will be as many arguments as there are terms 
in the expression, plus a final label to branch to if 
the search is successful. Each pattern is either a 
string, or the name of a string that is defined else- 
where. The object of the game is to match one string in 
each argument to a term in the input, with no leftovers. 

The order in which the student enters the terms does 
not matter. Leading plus signs can be omitted, both in 
the input and in: the IFTERMS command. At present this 
. command does nothing with parenthesized quantities: 
everything between a left paren and its matching right 
paren is considered part of the current term. 
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ALLWRONG. After an unsuccessful IFTERMS , allows the 
instructor to branch to the sequence appropriate to 
the mistake or misunderstanding. It must follow 
directly on the IFTERMS statement. 

ALLWRONG (TERMS ,GG) 

Tests to see if all the terms expected are missing; 
if so, it branches to GG. 
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Ex. 2 ALLWRONG (SIGNS, SS) 

Tests to see if all the terms are there, but all with 
the wrong sign, in which case it branches to SS. 

Ex. 3 ALLWRONG (TERMS ,G1) , (SIGNS ,S2) 

Transfers to G1 if all the expected terms are missing, 
but goes to S2 if they are all right except for the 
sign on each. 



NOTERMS . Allows the programmer to test on each or any 
of the terms separately after an unsuccessful IFTERMS. 

It also sorts out null strings and syntax errors, if 
requested, and checks for the case where we find all 
the expected terms plus extra terro(s). NOTERMS must 
directly follow either IFTERMS or ALLWRONG. 

Ex. 1 NOTERMS (MISSING, (3, Gl) , (2,G2,S2)) , (NULL,NN) , 

(TOOMANY ,TTO) , (SYNTAX ,ISYN) 

Will branch to NN if input is just a carriage return, 
to ISYN if there is a syntax error, to TTO if the 
expected terms are there, but there are extra ones in 
.the input. If none of these is true, it will look first 
to see if the term corresponding to argument 3 is missing, 
and it will branch to Gl if so. If term 3 was matched, 
it will look next to see if the second term is missing; 
if it is matched but with incorrect sign, it will transfer 
to S2; if no correct match for it was found at all, it 
goes to G2. If none of these conditions is true the next 
command after NOTERMS is executed. 

The options can be given in any order, identified by the 
key words as shown in the examples. Any option (s) may 
be omitted. 

l&SSING is followed by; 

the ordinal number in the IFTERM command, of the 
term' 'being considered; . / 

the label to transfer to if the term has not been 
matched; : ^ £ V '.V--.- ;.,V " 

(if present) , the label to branch to if . it is ; 
matched, but with incorrect sign. 
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The programmer experienced in the use of assembly 
language can do his own checking after an unsuccessful 
IFTERM , xising the stored information. 

R1 contains the # of terms expected in the IFTERM; 

R2 contains an error code: 

1 if input is null string; 

2 if syntax error; 

4 if all terms were matched, but there are 
excess terms in the input; 

5 if one or more terms were not matched by 
input terms. 

If R2=5 , two words store bit information: 

tGFLAG contains a 0 bit for each term matched, a 1 bit 
for each term not matched , in the order given in the 
IFTERMS command. The remaining word bits are 0. 

#SFLAG contains, in the same order, a 1 bit for each 
term which would have a match but for the sign, 0 for 
each other tern. 



TO (OTHER, AUTRE, B, JUMP) . The simplest form of this 
command has a single argument, a statement label, and 
causes an unconditional branch to that statement. If 
a second argument is present, it indicates the condition 
under which such a branch is to take place. This argu- 
ment is complex and is enclosed in parentheses: it has 

either two or thr^e parameters: the name of a counter, 

a relationship (optional) r and a number. The relation- 
ship may be GE- (greater than or equal to) , GT (greater 
than), NE (not equal to), LT (less than), LE (less than 
or equal to), EQ (equal to); if none is stated, GE is 
assumed. The branch takes place only if the counter 
correctly satisfies the specified relationship. 

Ex. 1 TO Q5 

The next statement to be executed is the one at Q5. 

Ex. 2 TO Q7,(CA,LT,5) 

Means, branch to Q7 if the counter CA is less than 5; 
otherwise take the next statement in sequence. 
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4. Manipulating Strings 

NOBLANK. Takes the blanks out of a string, which may 
be specified in the argument. If no argument is present, 
the input buffer (#IN) is assumed. Its normal use is 
after INPUT, when a match requires no blanks; it is 
particularly valuable in processing formulae or equations, 
where blanks can appear in random places. 

EX. 1 NOBLANK 

Takes the blanks out of the input buffer. Thus, if the 
student had typed "HORSE MAN SHIP”, after this command, 
the input buffer would contain "HORSEMANSHIP* 1 • 

Ex. 2 NOBLANK LAST 

Will take the blanks out of the string stored at location 
LAST. 

DELETE (REMOVE) . Removes part of the input string, it 
has one argument, a literal string or the label of a 
literal string, which is to be removed. The argument 
may be multiple, a series of literals enclosed in 
parentheses. In this case the first occurence of each 
string will be removed from the input. The first 
occurrence of that string is removed from the input. 

Ex. 1 DELETE **• 

Removes the first asterisk from the input. If the input 
does not contain an asterisk, the string is unaltered. 

Ex. 2 DELETE ( ’ * 1 , ' } f , ' ( ' ) 

Remove the first *, the first ), and the first ,(. 



EX. 



1 



DELETEALL- Removes part of an input string. It has 
one argument, a literal string or the label of a literal 
string, indicating the characters* that are to be removed. 
The argument may be a series of literals enclosed in 
parentheses; all occurrences of each string will be 
removed from the input. 

DELETEALL w ,” 

Removes all commas from the input string. If these are 
no commas, the input is unaltered. 

DELETEALL ( , A* , * I* , *0* , , U f ) 

Removes the vowels a, 'ey i, o, and u from the input 
string. 
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REPLACE (SUB, SUB : FOR) . Replaces the first occurrence 
of a specified string in the input with a second string. 
Two literal strings cure required as arguments: the first 

occurrence of the first string is replaced by the second. 

EX. 1 REPLACE * TWO 1 , * 2 1 

Replaces the character string "TOO* with "2" the first 
time it appears in the input. 



SUB ALL . Replaces each occurrence of a specified string 
in the input with a second string. Two literal strings 
are required as arguments: each occurrence of the first 

string in the input is replaced by the second. 

Ex. 1 SUBALL * 

Replaces each double asterisk with the up-arrow. If 
there is no **, the string is unaltered. 

ADDAST . Takes formula input by students and transforms 
them into a BASIC-like form. It inserts asterisks 
between letters, or between numbers and letters (in either 
order), and between a number or letter and the parentheses 
following or preceding it. It replaces the FORTRAN 
exponentiation "**" with It removes blanks. No 

argument is required. 

EX. 1 ADDAST 

Converts an input formula. If the student had typed, 

A**2 + 2AB + B**2 
this command would convert it to 
A+2+2*A*B+Bt2 



MOVE (MOVEZ) . Moves all or part of a string from one 
location to another. The arguments specify the strings 
from which and to which the move is to take place; the 
number of characters to be moved (if this parameter is 
omitted, it is assumed that all of the string will be 
moved. The user must take care that the location to which 
he is moving the string is defined large enough to contain 
the string moved, else he may overwrite other material. 

If he specifies more characters than the string contains, 
he will move garbage along with the string he wants. 

For the more advanced programmer who uses some assembly 
language in his programs, special forms of MOVE are 
available in which some parameters can be stored in 
machine registers* See examples below. 

Ex* 1 MOVE A,B 

Moves the entire string at A to B. A is unchanged * 
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EX. 2 MOVE A,D,40 

Moves the first 40 characters at A to B. If A does 
not contain 40 characters , garbage will be moved with 
it* 

Ex. 3 MOVE SAY, WHEN, *1 

r 

Moves the initial N characters of the string SAY, where 
N is the number in register 1, to string storage in WHEN. 

Ex. 4 MOVE (HOW, 3) r MUCH,*2 

Moves K characters of string HOW, starting with character 
number 3, to MUCH, where K is the number in register 2. 

Ex. 5 MOVE (HOW, *3) ,MDCH,*2 

Moves K characters of string HOW, starting With character 
number J, to string location MUCH. K is the value in 
register 2 and J is the value in register 3. 



PTRMOVE. Was designed for moving strings whose location 
is stored in a known address. The instruction is of 
the form: 

PTRMOVE *A,*B 

where the address of the string to be moved is stored in 
A, and the address of the new location is stored in.B. 

Variations of this are the use of indexings: 

PTRMOVE (*A,1) ,*B 

moves the string whose address is in the nth word of A, 
where n is the value stored in register 1. This operation 
may be applied to the 2nd argument also. 

In certain cases the asterisk may be left off either or 
both arguments. 

PTRMOVE A, C*B,D 

In this case it is assumed that A is the name of the 
string to be moved . By leaving off both asterisks , the 
operation becomes the same as MOVE. 
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APPEND . Concatenates one string on to the end of another, 
modifying the character count appropriately. The second 
string remains unchanged. The arguments specify the 
string to which and the string from which characters arc 
to be moved. Note that this is the opposite order of the 
parameters in MOVE. The user should be careful not to 
append more characters than the defined string location 
has room for. 

Ex. 1 APPEND A,B 

Adds string B to the end of string A and modifies the 
count of string A to reflect A*s new length. 
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5. Manipulat i ng N umber ti 

NUMBER. Examines a character string to see if it 
constitutes a recognizable number and, if so, converts 
to floating point form and stores the number. The first 
argument is the location in which the number is to be 
stored; the second argument is the location to go to 
if the string is not a recognizable number; the third 
argument, if present, is the location of the string. If 
there is no third argument, the input buffer #IN is 
assumed* 

Ex. 1 . NUMBER TIME, NOGOOD 

Examines the input buffer and_either stores the converted 
number in TIME or branches, to . NOGOOD . 

Ex. 2 NUMBER TIME , NOGOOD , NSTRING ^ 

Does the same for a string in NSTRING. 

A "recognizable number* in this and other commands testing 
for numbers is defined as being of the following form: 

[+ J XX I . J XX [E [+1 X [Xj ] 

where the brackets indicate optional characters and there 
can be 'any number of digits X in- the part of the number 
preceding the exponent. 

SCAN . .Separates a string into three parts: that part 

containing a number, the part before it, and the part 
after. Either four or five arguments are required: the 

location at which to store the number; the location for 
the characters before the number; the location for the 
characters after the number ; an error location if no 
•number is found; the string location (if omitted , input 
buffer assumed). All strings must be defined by the 
user. If there is no number, a branch to the error 
location occurs and zero counts are stored in the three 
specified string locations . All blanks are removed from 
the string scanned, whether or not the operation is 
' successful. : \ ;: r ' ■’ 

Ex. 1 -SCAN NUMST,STBEF,STAFT,ERR 

Scans the input buffer for a string of characters 
representing a number. That string is stored in NUMST; 
the characters which preceded it in STBEF ; the characters 
which followed it in STAFT. If no number is found, 

NUMST, STBEF, STAPT are given zero counts and a branch to 
ERR occurs, v : -V : - v Vv — . 
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SCAN# . Performs all the functions of SCAN but also 
converts the number into floating point form for use 
in computation. 

Ex. 1 SCAN# NUMST, STBEF, STAFT, ERR 

Stores the. string preceding the number in STBEF, the 
string following the number in STAFT and. the number, 
converted to floating point form, in NUMST. 



IFN UMEX . Tests the input string (or any other string) 
to "see if it is a number (only) . The first argument 
is the location to which to branch if the string is 
exclusively a iriraber; the second argument (if present) 
is the location of the string to be tested. If absent, 
input buffer is assumed. 

EX. 1 IFNUMEX NEXT 

Branches to NEXT if the input buffer contains only a 
number . 



IFNOTNUM. Is the reverse form of IFNUMEX. It tests 
the input string (or any other string) to see if it is 
a number (only) . The first argument is the location 
to which to branch if the string is not exclusively a 
number; the second argument (if present) is the location 
of the string to be tested. If absent, input buffer is 
assumed. 

EX. 1 IFNOTNUM NEXT 

Branches to NEXT if the input buffer is not exclusively 
a number. 

AROUND . Tests the range of a floating point number. 

There are four arguments? the number, the central value, 
the . deviation from this value allowed, and the successful 
branch point. 

Ex* 1 AROUND N,S>E, GOTO 

IF S—E <N<S+E , the program will branch to GOTO; if not, 
the next instruction in sequence will be taken. S and E 
are the locations of floating point numbers* 

Ex. 2 AROUND ^{'XrFS* 6 .S^FS* 0.02* ,BRM»CH ; 

IF .48<K<. 52, it branches to BRANCH, else takes the next 
instruction. *FS* here indicates a floating point number 
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BETWEEN. Tests the size of a number. There are four 
arguments : the number to be tested, the lower bound, 

the upper bound, and a branch location. The bounds 
can be either locations where the bounds are stored or 
actual floating point numbers. 

Ex. 1 BETWEEN N , BOTTOM , TOP , GOTO 

If the number at N is between the values of BOTTOM and 
TOP, inclusive, it branches to GOTO; if not, the next 
instruction in sequence is taken* 

Ex. 2 BETWEEN N,FS*12.5 ,FSM2.8 f ,T749 

If the number at N is between 12.5 and 12.8, it branches 
to T749. Note the format of floating point constants; 
see the Metasymbol manual for further details. 



RANDOM . Generates and stores random numbers. The first 
argument is the location at which it is to be stored. 

The second and third arguments (optional) indicate the 
range, if they are omitted, the number will be between 
0 and 1. A sequence of random numbers generated by a 
series of calls is unique: no other runs of the program 

will generate the same sequence. 

Ex. 1 RANDOM X,A,B 

Generates a random number between A and B and stores it 
in X. . 

Ex. 2 RANDOM Y 

Generates a random number between 0 and 1 and stores it 
in Y. 

Ex* 3 RANDOM A,FS f 0 # ,FS , 50.0V 

Generates a random number between 0 and 50 and stores it 
in A. ("FS ,, indicates a floating point number.) 

RANDOMR. Is like RANDOM, except that the sequence of 
numbers gene rated is repeatable : that is , every run of 

the program will generate the same sequence of pseudo- 
random numbers*; 
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6. Manipulating Counters 

BUMP (INCREASE, AUGMENT, ADDl) . Increases the value of 
a counter (or counters) by 1. The argument is the name 
of the counter (or counters, separated by commas and 





enclosed 
is 255. 


in parentheses). The maximum value of 


a counter 


Ex. 1 


BUMP 


Cl 




Ex. 2 


SUMP 


(C2,C23,A) 






DECREASE (S r JBl) . Is used to decrease the value of 
counters by 1. The argument specifies the name of the 
counter to be bumped, or the counters, if more than one, 
separated by commas and enclosed in parentheses. 


EX. 1 


DECREASE 


Cl 




Ex. 2 


DECREASE 


(C2/C23,A) 





The minimum value for a counter is 0. 



RESET (ZERO) . Stores a new value in specified counters. 
The first argument is the name of the counter or counters; 
the second is the value to which the counter is to be set. 
If the second argument is missing, zero is assumed to be 
the value. • 

Ex. 1 RESET (AB,C2,Q17) 

Gives the three counters the value of zero. 

Ex. 2 RESET Q17,4 

Gives the counter Q17 the value 4. 

ADDCQUNT . Sums two or more counters and stores the 
result in one of them. The first argument is the name 
of the counter in which the sum is to be stored. The 
second argument is the additional counter (or counters, 
separated by commas and enclosed in parentheses) . 

Ex. 1 ADDCOUNT S,A 

Adds counter A to S and stores the sum in S. 

Ex. 2 ADDCOUNT \ S, (A,B,R) 

Adds counters S, A, B, and R and stores the sum in S. 
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CTAK1TH. Enables the user to add, subtract, multiply or 
divide counters. The operation is specified in the 
second argument field. The fourth argument is the branch 

point in case of error; all counters remain in original 

form. Error conditions are 

Ex. 1 

overflow — value > 255 
underflow — value < 0 
division by 0 



Ex. 1 


CTARITH 


A ,ADD ,B,C 

ADD A TO B LEAVE IN A 


Ex. 2 


CTARITH 


A ,SUB,B,C 

SUB B FROM A LEAVE IN A 


Ex. 3 


CTARITH 


A,MULT,B,C 

MULT A BY B LEAVE IN A 


Ex. 4 


CTARITH 


A,DIV,B,C 

DIV A BY B, TRUNCATE AND LEAVE IN A 




CTWRITE. 

counter 


Outputs a CRLF and then the value of any 
in decimal form. 


Ex. 1 


CTWRITE 


T2 



If T2 has the value 5, this generates a carriage return 
and line feed, then the number 5. 



CTOUT. Output just the counter value (no CFLF) . 

Ex. 1 CTOUT A 

If the counter A is 2, this prints 2 on the current line. 

SWITCH . Is a command for testing the value of a counter 
and branching to one of several locations, depending on 
its value. The first argument is the name of a counter. 
The second argument is a set of statement labels 
(separated by commas and enclosed in parentheses) to 
which to branch on sequential values of the counter, 
starting with zero. If the value of the counter is 
greater than the number of branch points supplied, the 
SWITCH is ignored and the next command is executed. 
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For specifying a number of branches , SWITCH is more 
efficient in execution than a series of TO*s although 
functionally equivalent. 

Ex. 1 SWITCH A, (A0,A1,A2,A3,A4) 

Eranches to AO if A is zero, A1 if A is 1, A2 if A is 2 
and so on, but goes to the next command in sequence if 
A is 5 or larger. 



is prints 2 on the current line. 
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7. Constant and Paramo tor Storage 

DEFINE (DEF IKEZ ) . Reserves space for the storage of 
strings of characters , including the character count# 
and defines the label which will be used to refer to 
it. The first argument is the label# the second is the 
number of characters. If the second is omitted , 16 
characters are assumed. The user can use the same 
. space for different things in different parts of his 

program. It is his responsibility to be sure a string 
area is large enough to contain the string moved into 
it or appended to it. There is no limit to the length 
of a string or string area but if the string is to be 
used as a message it should be limited to what can be 
printed on one line (70 characters ) . 

Ex. 1 DEFINE STR1 

Reserves storage for 16 characters# to be referred to 
as "STRl". 

Ex. 2 DEFINE STR2#70 

Reserves storage for 70 characters # to be referred to 
as "STR2** • 



COUNTER (COMPTEUR# C) . Defines a label as referring to 
a counter and reserves space for that counter. The 
first argument is the label or a sot of labels for 
several counters , separated by commas and enclosed in 
parentheses* The second argument is the initial value 
the counter (s) is to have. If the second argument is 
not present# the counter (s) will have an initial value 
of zero. Currently# 32 counters are allowed in the 
program; the maximum value for a counter is 255. Any 
'number of COUNTER statements may appear in a program 
(up to 32) # but no counter should appear in more than 
one COUNTER statement as this is a multiple definition 
of a label. 

Ex. 1 COUNTER AQS 

Establishes a counter to be called AQS# with an initial 
value of zero. 

Ex. 2 ' ■ ■ ' COUNTER B#5 

Establishes a counter# B# with an initial value of 5 . 

Ex. 3 COUNTER (C#D#E#F> #7 

Establishes counters C # D# E, and F# each with initial 
value of 7. 
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, D, E, and F, each with initial 



Counters can have any name {within the limits on label 
names) as long as it is not used for any other purpose. 
One convenient procedure is to use a name related to 
the label of the WRITE statement where the counter is 
first used; thus, if the WRITE statement is labelled 
T32, the counter might be labelled T32C. Or, the counter 
name might indicate the function of the counter. But 
the user does not have to follow any such naming 
suggestions . 



SET. A roecasymbol command enables the user to define 
(at assembly time) , a label or labels by assigning to 
each the attributes of the list in the argument field. 
It can be used to supply synonyms for counter names, 
for instance (this may be useful for mnemonic purposes *) 
It can also be used to give specific arithmetic values 
to labels, Labels have the values assigned until they 
are redefined by another SET statement. 

Ex. 1 



Ex* 1 



Strings are stored internally in the conversational 
system in a fashion different than in supplied Sigma-7 
software. The full first word of this string contains 
the number of characters in the string; the characters 
begin with the first (left-most) byte of the second 
word. The command enters strings in this fashion* This 
change was made because in some instances it is advisable 
to work with strings of more than 256 characters, the 
maximum which can be stored with the TEXTC command in 
Metasymbol . All of the procedures and subroutines in the 
system assume string storage as just outlined. 



ABC 

A1 

A2 



SET 

SET 

SET 



DEF 

23 

Al*2+3 



In these statements, ABC is given as a synonym for DEF 
( vhich roust be defined elsewhere; A1 is the number 23 
and A2 is defined in terms of Al. Labels originally 
defined by an EQU or by a COUNTER statement may not be 
redefined with a SET* 



TEXT# . Defines a character string, specifying the name 
which will be used to refer to it. The label field 
contains the name of the string; the argument field 
contains a literal string. 



AZ TEXT# 



• VELOCITY f 



Stores the characters "VELOCITY" at a location identified 
as AZ. Thus a statement WRITE AZ will produce the word 
VELOCITY at the student terminal. 
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STRING. Is similar to TEXT# , but it has a branch around 
the text-string itself. So STRING can be "executed 1 * (it 
does nothing) , while TEXT# cannot. The beginner who is 
uncertain of this distinction should use STRING. A 
string which needs to written out many times should be 
stored this way. 

Ex. 1 GREET STRING ’GOOD DAY 1 ’ 

Stores the string ’GOOD DAY! ■ under the name GREET. 



DEFNUM . Reserves storage space for individual floating 
point numbers and assigns labels to the storage. The 
argument is the label or labels (enclosed in parentheses , 
separated by commas) . 

Ex. 1 DEFNUM WEIGHT 

Reserves a single storage space for a variable WEIGHT. 



Ex. 2 DEFNUM (X,Y,Z) 



Reserves storage for three variables. 

Used with one argument, this directive only reserves 
storage and does not establish any initial value. 
Assigning values is the user’s responsibility. 

An optional second argument can be used to store an 
initial value for each label defined in the first 
argument. The second argument is one number, or one 
symbol only. 

Ex. 3 DEFNUM (X,Y,0), FS'3.5* 

Will define locations X, Y and 0 and place a floating 
short 3.5 in each of them. 

Ex. 4 DEFNUM K,. R 

Will define location X, and store in it the floating 
point number which is new in location R. 
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STORENUM . STORENUM has two argi*ments, The first is a 
location previously defined by DEFNUM, and the second 
is a floating short number which is then assigned the 
first argument. 

STORENUM A,FS f l f 

Places a floating short one in A which is previously 
defined* 
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8, Other Commands 



DEFCOMP- DEFCOMP works in the same manner as DEFNUM 

except that for each label it reserves a double word** SYSTEM DI 

It also may assign a value at time of definition. This DIALOG co 

is done with a complex second argument which contains during th 

two floating short numbers. The reserved number may the pr 

then be handled with doubleword commands. 

NAME 

Ex. 1 DEFCOMP A, (FS *1 1 ,FS *2 * ) START 



Will reserve two words addressed by A with a floating Either 

short 1 in the first and a floating short 2 in the command a 

second . 



STORECOMP. STORECOMP will store two floating short 
numbers in a previously defined complex number. 

Ex. 1 STORECOMP A, (FS 1 1* ,FS '2 1 ) 

Would store a floating short 1 and 2 in the doubleword 
defined as A. 



DEFTABLE . Reserves storage space for tables or linear 
arrays of floating point numbers. The first argument 
is the label to be assigned, the second is the number 
of words in the table. 

Ex. 1 DEFTABLE TIMETAB, 100 

Reserves 100 words for a table which will be referred 
to as TIMETAB. Numbers can be stored easily in tables 
like this using the command STACK. 

STACK . Stores numbers into a table or linear array 
(which must have been defined using the DEFTABLE 
directive). The first parameter is the location of the 
number; the second is the name of the table; the third, 
if given, is the branch point for overflow . (If no 
third argument is given, table overflow is marked by a 
warning printout: •'Table overflow, value not stored," 

and the next sequential instruction is executed. This 
is. not generally advised. STACK is useful in simulations 
for storing student measurements. 

Ex. 1 STACK TIME, TIMETAB 

This will store the current value of the number TIME 
into the next available space in the table TIMETAB; i.e., 
if there are 100 words reserved for TIMETAB, and 16 have 
already been filled, TIME will be stored in the 17th. 
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8. Other CoiTuna nds 

SYSTEM DIALOG . Directs the assembler to select the file 
dialog containing the commands that are to be valid 
during this assembly. This must be the first statement 
in the program. 

NAME 

START 

Either NAME or START must follow the SYSTEM DIALOG 
command at the beginning of the program. 



START . Initializes the flow of instructions when 
execution begins. 

NAME ’AJAK' . Does the work of START, but in addition 
uses the f4 or less) characters in the argument to 
name the response file on which the students* responses 
will be saved if any of the SAVE commands are used. In 
this case the file name would be 'RES AJAK * . It also 
stores these characters as part of the students * ID on 
the name file, which keeps records of starts (and 
restarts , if ENTRY is used) . 

END . This indicates to Metasymbol that it is the last 
statement to be processed. See Sec. 1-2 for discussion 
of END DIALOGUE and END without an argument , or with a 
different argument. 



STOP (HALT) . Indicates that this is the last instruc- 
tion in the program which will be executed: i.e. , when 

the student uses the sequence, he is done at this point, 
and control is returned to the executive. It also 
erases from the name file the record, containing this 
student* s ID. It is not necessarily the last statement 
in the program. Nor need it be unique t there may be 
several exits from the program. 

FINALE (EPILOGUE, _ EPILOG) . Indicates that this is the 
last instruction in the program which will be executed. 
When the student reaches this point, he is asked to 
type a comment about the sequence . This comment is 
saved on disk. Control is then returned to the executive. 
Use of this instruction is optional; some authors prefer 
to dp this themselves, or not do it at all. 
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ENTRY . Is the command which permits restart. It does 
not need to be used. If it is used, the student who 
does not finish a conversation in one sitting can restart 
at some place other than the beginning. The command 
ENTRY should be used at all locations at which the 
teacher wishes to allow a restart. Normally, it should 
be just before a WRITE command, so that the student will 
not be restarted at an input. Restart occurs at the 
last executed ENTRY. 

If no ENTRY is used in the program, the student begins 
directly with the user program. If one or more ENTRY 
commands are used, he is first asked to type an ID; 
this identification is used for restarting. Further, 
if the program uses any ENTRY commands , the student is 
reminded of his ID after he types STOP at any input. 

In a program using restart, if the student uses a 
previous identification, he is asked whether he has used 
the dialogue before. If so, he is restarted at the last 
entry point executed when he first ran the program. 



SAVE (KEEP, INFO) . Causes information to be stored on a 
disk file (while the program is running) for later study. 

It has two forms to save student responses and to save 
counters. The form to save responses has one argmnent, 
a character string which will serve as the name of the Ex. 1 

record as it is stored on disk. When SAVE is encountered 
in running the program, the contents of the input buffer, 
the date, the time, and the name are saved. The name 
should be no longer than 40 characters. One possibility 
is to use the label of the preceding WRITE statement . 

The SAVE command for preserving the values of the counters 

has three arguments: the first must be COUNTERS; the . 

second is the name of the counters (separated by commas 

and enclosed, by parentheses) or ALL; the third is -a 

character string to serve as a name. If the third 

argument is omitted, the name •’COUNTERS* will be used* 

Ex. 1 SAVE 9 RESPONSE 1 ’ 

Saves the input buffer, time, date# and the name Ex. 2 

-RESPONSE 1* on disk. \ 

Ex. 2 SAVE COUNTERS , ALL # 9 KEPLER * 

Saves all of the defined counters under the name 
-KEPLER". I fv 



Ex. 3 
Ex. 4 



39 



38 



^Lts restart- It does 
|ed, the student who 

one sitting can restart 
ming. The command 
Lons at which the 

Normally, it should 
go that the student will 
Estart occurs at the 



the student begins 
I If one or more ENTRY 
bleed to type an ID; 
Restarting- Further, 
nands, the student is 
STOP at any input. 

fie student uses a 
>ked whether he has used 
Ls restarted at the last 
st ran the program. 



nation to be stored on a 
running) for later study, 
it responses and to save 
>nses has one argument, 

/e as the name of the 
When SAVE is encountered 
»nts of the input buffer , 
are saved. The name 
icters. One possibility 
ling WRITE statement. 

|the values of the counters 
nust be COUNTERS ; the 
rs (separated by commas 
j; the third is a 
ne- If the third 
HUNTERS" will be used* 



Ite, and the name 



\s under the name 



O 

> ERIC 



39 



Ex- 3 SAVE COUNTERS , (Cl , C2 , C3 ) ,*K* 

Saves the three listed counters under the name "K" • 

Ex- 4 SAVE COUNTERS, K2 

Saves only the counter K2 and assigns the record the 
name -COUNTERS n . 



SAVEID . Is identical in function to SAVE except that 
the student ID is presewed as part of the disk record. 



FORTRAN - Allows the user to introduce FORTRAN subroutines 
into his dialogue. Any number of FORTRAN subroutines can 
be called any number of times within a dialogue program 
subject only to the limitations of space- All FORTRAN 
facilities in XDS FORTRAN IV are available to the user. 

The subroutine itself must be compiled using the XDS 
FORTRAN IV compiler ( not IV-H) and is loaded along with 
the rest of the program. 

The argument of the command is the name of the FORTRAN 
subroutine together with (in parentheses) the arguments 
for the subroutine. 

Ex. 1 FORTRAN POLLY, (X,Y,Z) 

The default assumption is that the subroutine arguments 
are real variables; the user can specify if he wants 
the variables to be integers, complex numbers, etc., 
according to the following table; 

1 Integer 

2 Real 

4 Real double precision 

8 Complex • 

10 Double complex 

20 Logical V • 

3F Any argument type 

EX. 2 FORTRAN KATINV, ( (1,1) , (J ,1) , (2,8) ) 

Calls a subroutine in which I and J are integers and Z 
is complex. 

HERE (MARK) . Simply identifies a location in the 
program. 
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LOAD (TRA NSF ER) . Brings into core the program segment 
whose binary* name (in single quotes) is the first 
argument. If the second argument is present, a branch 
is made to that label. Please read Section 3.7 on 
OVERLAYING for a more complete discussion. 



Ex. 1 



LOAD 



•CONIBO 9 ,C5 



Ex. 2 



Brings into core the binary file named CONIBO, and 
branches to C5. 



Ex. 2 



TRANSFER 



'BR3' 



Brings into core the binary file whose name is BR3. 
Presumably the programmer will later transfer to the 
instructions in BR3 by a TO command or its equivalent. 



t 



AUDIO . Works like a WRITE command, except that the 
message is delivered in an audible fashion using the 
RAAD audio response device, (William M. Brobeck and 
Associates), rather than through the teletype. 



& 

h 



Ex. 1 



AUDIO 



VOICEI 



VOICEI is the location in which information is stored 
identifying the audio record. 



(■ 



r 



TALK . To indicate the audio record, five pieces of 
information must be. given , for the RAAD device . These 
are given in order, as a set of hexadecimal digits by 
the following command. 



VOICEI 



TALK 



X f (digits) • 



Thus TALK supplies, the information about the location 
of the audio record. It must, be labeled and referenced 
by the audio command that actually produces the talking. 
VOICEI is a label, starting in column 1. 



ANSWER. Works like INPUT, except that it checks the 
student input for REPEAT, repeats the last audio 
message, and continues from there. Normally, it should 
be used only after AUDIO. 



Ex. 1 



GOOD * GOOD will randomly choose one of ten statements 
equivalent to "correct". It may be used without any 
argument. 

GOOD 
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In which case the next instruction will be executed 
after the GOOD response is printed. 

It may also be called with an argument which is the 
address of a location. 

Ex. 2 GOOD OUT 

In this case, after printing the message the program 
will branch to OUT. 



AGAIN. Will randomly choose one of 10 statements 
equivalent to f try again 1 , it is used with or without 
an argument, as in the command GOOD. 



GREETING . Displays a greeting to the student appropriate 
to the time of day: 

Good Morning, 

Good Afternoon; or 

Good Evening 
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CHAPTER 3 

GETTING IT ON THE MACHINE 

If the reader has had no previous experience using the BTM 
timesharing system, he will need some assistance in learning how 
to load, debug, and run his program. Probably the most effective 
method is to ask an experienced Sigma 7 user to spend a little 
time with you until you know the ropes; after that, you can refer 
to the XDS manuals for additional information. However, it may 
be helpful to have some material in tnis convenient location. We 
have by no means attempted to explain the full power of the systems 

described; only enough information is provided to get the beginner 

* 

going* 

In what follows, it is assumed that the program is to be typed at 
a terminal and stored on disk; it will be modified and corrected, 
assembled, tested, and finally made available for student use* 
Before you begin, you will need a legal account number; check with 
your computer center on this* You will need to know the account 
containing the dialogue system and libraries as well. (At Irvine# 
it is B9999*) 

1. Using the terminal 

To sign on, you. must press the "Break* key. The system will 
announce itself and ask you to identify ■ yourself with name and 
account number. Once this is accomplished, the system will type 
an exclamation point, which means that it is waiting for you to 
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tell it what you would like it to do next. Here are some of the 
functions of the monitor which you^will want to be able to use. 

In these examples, messages output by the monitor are underlined. 
Note especially that, in calling for any of these functions, the 
user types only the first two characters; BTM finishes the word. 



1 LOGIN: (this asks the user to type his name and account 

number. When you have done this, press carriage return. 
If you are acceptable to the system, it will type an 
exclamation point and wait for your command.) 

I TABS (type the numbers of the character positions 
where you would like to have tab stops , separated by 
commas. Carriage return when you are through.) 

I EDIT (calls for the text editing program which you 
will~ use to input your program. More below on this.) 

IB YE (indicates that you are finished and wish to sign 
off7) ■ * 



There are some special typing conventions which the user should 
be aware of: 



Return to executive : when the user is in some system or 

subsystem, he may wish to return control to the executive, 
fie does this by pressing the ’•escape*’ key twice — perhaps 
several times. 

Backspace : "escape* and "rubout", will cause an effective 

backspace in the information being stored in the machine. 
It may not cause an optical, backspace In the material you 
see on the terminal, however. 

Erase: "escape" "X" causes the entire present line to be 

deleted from the machine. Again, it will not necessarily 
be removed from the terminal. 

Retype : "escape" and "R" cause the complete statement to 

be retyped. If there have been backspaces and erasures, 
it is sometimes nice to be able to see exactly what you 
have done. The machine waits for further input. 
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Tab : "escape" and "I" cause spaces up to the next tab 

stop. Tabs must have been set previously at the 
executive level . 

Check status : "escape" and "Q" cause the system to 

type ‘’ll". This is useful (after a long pause, for 
example) for checking whether the system is still alive. 



2. Using EDIT 

The EDIT system allows the user to create, modify, and list disk- 
resident files. This is one way to enter programs. (Cards cure 
also a possibility.) Once the user is satisfied that his program 
is complete, he can then assign it as an input file for Metasymbol* 



EDIT announces itself with an asterisk and waits for the user to 
specify one of its commands . All of them will not be discussed 
here; the BTM Users Manual gives a user-oriented description of 
each* You should be able to get a good start with the pieces 
described here* 



♦BUILD fid (i*e., EDIT types the asterisk, you type 
^BUXLD" and then some file identification of your 
choice, then carriage return.) When this command is 
accepted, a new file is created on disk with the name 
you have specified* EDIT then types a line number 
(1.000) and waits for you to fill the line. A carriage 
return, as usual, terminates the line and another line 
number is typed. If you return the carriage without 
typing any characters:, it is assumed that you are done 
with BUILD and want to call another EDIT function — it 
types another asterisk* Because of the oddities of the 
BTM system, it is wise to terminate BUILD in this way 
before you get too far in your typing so as to establ i sh 
your file on disk, and then add . to it using the IN 
//;;^command. •; -.h' ; '-- 

^END Returns control to the executive — which types an 
^clamation point to let you know it is there. 
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^DELETE fid This allows you to remove the file from 
disk. It effectively destroys the file and all 
references to it. % 

♦EDIT fid This allows you to edit a text stored on 
disk. All this command does is indicate that you 
wish to edit a particular file, which you identify 
by name. Following it, you must specify what you 
want to do. Only a few of the possibilities will be 
described here; IN, DE, TY, SE. 

^DE n-m Deletes records n through m. Do not confuse 
DE with DELETE which removes the entire file. 

^TY n-m Types records n through m. If ra is omitted, 
only n will be typed. If you wish to type to the end 
cf the file and do not know the number of the last 
record, simply use a very large number for m. 

♦SE n;/strl/S/str2/;TY SE is a powerful command with 
many variations. This one is particularly useful: In 

line n, substitute str2 for strl (first occurance only) 
and type the new line. Follow the indicated punctuation 
carefully. 



3. Using Metasymbol 

Metasymbol programs must be assembled as a batch job — in BTM 
they cannot be assembled on-line with direct feedback on the 
terminal. The control information and the instructions for the 
assembly, however, .can be submitted from a terminal as well as 
from cards. In either case, the file with the course material 
will be input to the assembly program. 

The following suggested possibilities for assembly ass ume s BTM 
version E00; later versions may have different characteristics. 
Let us assume that the conversational file stored on disk is 
called COURSE and that we intend to give the binary output of 
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the assembler the name COURSEBO . The following •cards 1 will 
perform the assembly (first character in column 1) : 



I JOB 


(accounting information — inquire 
locally for details) 


I LIMIT 


(TIME, 5) 


! ASSIGN 


M:SI, (FILE, COURSE) 


I ASSIGN 


M:BO, (FILE, COURSEBO) 


1 METASYM 


LS,SI ,BO,AC (B9999) 



The JOB card contains accounting information; details may vary 
from installation to installation; someone familiar with your 
computer set-up will be able to help you here. The second card 
sets a limit on the amount of time to be used in this particular 
job. Setting a five minute limit simply protects you from the 
chance of some error which would cause your job to run on 
endlessly — and your account to be billed accordingly. The ASSIGN 
cards specify files related to your program. The system input 
(:SI) is to be an existing disk file (FILE) called COURSE. The 
binary output of the assembly (BO) is to be a file called COURSEBO. 
(The : \ \jre ether functions which the ASSIGN directive will perform; 
details will be found in the BPM and BTM manuals . ) Pay particular 
attention to the punctuation of these statements; they have been 
the despair of more than one amateur typist. 

The final card of this set indicates that the system program you 
will be using is tt^tasymbol (METASYM) . The information in the 
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di cates that the system program you 
(METASYM) . The information in the 



argument field is to specify what precisely you wish the assembly 
program to do. Three of these arguments are required in our 
situation: 

SI specifies source input 
BO specifies binary output 

AC specifies that the dialogue procedures are to be 
found in a file in account B9999. (At installations 
other than Irvine, this number may be different.) 

Other arguments are optional: 

LS requests a listing of the source program 

LO requests a listing of the output — assembly 
language and machine language code generated. 

CN requests a concordance. The METASYM card must in 
this case be followed by one or more concordance cards 
(see Metasymbol Manual) . The last card must contain 
(columns 1-4) .end . 

SD specifies symbolic debugging facilities: special 

dictionaries are prepared and saved so that the DELTA 
debugging program can be used. (Cannot be used in the 
final" version.) 

To enter the batch processing system from the terminal , type BP 
nt the executive level (i.e., after a 1 prompt character). Y is 
the correct response to "INSERT JOB?"; no carriage return is needed. 
Then the above four lines can be typed. A blank line terminates 
input and the user can reply *N* to the "EDIT?" question. A 
terminal message indicates that the job has been inserted. From 
the standpoint of the computer, this job Is just the same as if it 
had come in from cards. You can pick up the (line printer) output 
from the computer center; if you are in a hurry, you can use FERRET 
to send a message to the operator , io inquire whether the job has 
b©en run and whether there were errors* 
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An alternative procedure is to place these tf ame "job* statements 
at the beginning of the "COURSE" file, or whatever file is the 
source file, before SYSTEM DIALOG; in this case the "M:SI" 
statement must be omitted. Then at the executive level (terminal 
prompts with f ! • ) type 

I AS SIGN M ; SI, (FILE, COURSE) 

The underlined characters are supplied by the computer. Enter 
BPM as just described to assemble your program, replying N to 
EDIT?. Another possibility, useful for long jobs, is to place 
the job •cards* in a separate file, with the M:SI statement left 
in, and assign the job- ^ard file as the source input file. 

A successful assembly is necessary. METASYMBOL error messages 
identify sources of trouble, and the dialogue system also contains 
messages to assist the author. You should not be discouraged by 
the several assemblies needed for correcting errors. The row of 
asterisks at the lefthand margin on the printout indicates an 
error. Mostly errors are obvious on looking at them but occa- 
sionally the advice of an experienced programmer may be necessary. 
Very few programs of any complexity acre initially without error, 
so a number of error runs are expected. 

A common mistake is the use of a label more than once within the 
program. The assembler complains of a doubly defined symbol when 
you refer to such a label. You should give a new name to one of 
the offending statements and check the occurrences to see which 
label is needed when. A concordance, obtained during assembly, is 
useful because it shows where the offending label has been used. 
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The 'find and type* command (FT) of EDIT is also very useful in 
tracking down labelling problems. Other common errors are the 
placing of a space after a comma, the omission of a quote, and 
the confusion of the letter 0 with zero. 

A code is assigned to your program indicating the "severity* of 
the errors. 

The binary file prepared by the assembler can be loaded using the 
LOAD subsystem at the terminal, and specifying the binary file 
(COURSEBO in the example above) as an "element file". The option 
U(B9999), where B9999 is the account with the dialogue library, is 
required* If on-line debugging using DELTA is desired by an 
experienced programmer option "D" is also needed. File assign- 
ments are made in the program, so only a carriage return is needed 
after "F: w . Reply "Y (Carriage return)" after XEQ, and execution 
will begin. (If you use DELTA, ;G starts the program.) 

4. Using Delta 

Undoubtedly you will want to try the program, looking for bugs, 
after it has been successfully assembled. Keep the flowchart and 
the program listing available during this testing, making a point 
of checking at least the main branches. Testing of this kind will 
not discover all the bugs: only student usage will do that! 

Delta is the name for a subsystem of BTM which can be a great help 
in testing your program, and is also the same for related facilities 
in the RUN and LOAD subsystems. It allows you to operate small 
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parts of the program , stopping to see what is in the counters and 
other storage locations. As with the other systems described here. 
Delta has more capabilities than we list. The facilities described 
here are enough to get a beginner started using the DELTA facilities 
in LOAD. Read the Delta chapter in the BTM manual to find other 
things which will be useful. 

Let us assume that our program has been successfully assembled and 
is now on disk in binary form under the name COURSEBO. We have the 
program listing, the flowchart, and some notes on how we want to 
proceed with the testing. After signing on, we specify that we want 
to load a program. The dialogue with the machine will proceed as 
follows. (Underscoring indicates typing by the system.). 

I LOAD 

ELEMENT FILES: COURSEBO 

OPTIONS : D,U (B9999) (for delta) 

F: (type carriage return only; 

no additional files are 
required) 

SEV.LEV. « 0 

■ *» NO UNDEFINED INTERNALS ♦» 

At this point a bell rings; Delta is ready for instructions. The 
primary facility available is the use of breakpoints . A breakpoint 
is a location in your program at which you wish the computer to 
stop, tell you where it is at and allow you to ask some questions. 
You will want to set breakpoints along all of the possible paths of 
the program segment you are interested in checking. Here are the 
commands to Delta controlling breakpoints: 

e;B (set the next available breakpoint at location e) 

e,n;8 (set the nth breakpoint at e) 
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n;B (remove the nth breakpoint) 

;B (type all of the breakpoints now in the program) 

You might begin by typing a list like this : 

ST1; B (the first breakpoint at label ST1) 

M34+1? B (the next breakpoint one machine instruction 
past M37) 

We assume the SD Metasymbol option here? it allows DELTA to 
recognize your labels. After running the program, you may wish 
to revise your strategy and remove or change these breakpoints. 

Then you would use the other forms listed above. 

Having set up the breakpoints , it is necessary to start to run 
the program. The command 
;G 

causes it to start at its normal beginning. The command 
ST1?G 

causes it to start at label ST1. The program will proceed 
normally until it reaches one of the breakpoints specified. This 
will be announced with a line like this: 

1; B ST1 (first breakpoint; at locations ST1) 

It is now possible to examine the contents of various storage 
locations and machine registers, to be sure that things are going 
as expected. 

e/ (display the contents of location e) 

e(C/ (display e as a character string) 

e(S/ (display e as a floating point number) 

e(I/ (display e as an integer) 

Line feed (display the word immediately following the 

one just displayed) 
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After the content of a word has been displayed, that word is 
considered to be "open . " The user may type a new value for that 
word, hit the carriage return, and the new value will replace the 
one just displayed. 

After the user is satisfied with the information he has received 
about the present breakpoint and the modifications he may have 
made, he may continue operating his program by typing 
;P 

or he may wish to begin again or start somewhere else using the 
;G command, described above. When he is done working with his 
program and wants to return to the executive* he can accomplish 
this by two escapes. 

5. Generating a load module 

The version of the program to be used with students should be 
generated as a load module. Assuming that the programmer has 
successfully generated the binary file COURSEBO, without error 
and without the use of the SD option on the METASYM card, the 
following job will create the load module PR0G1: 

1 JOB (accounting information) 

1 LIMIT (TIME, 15) 

l LOAD (EF , (COURSEBO) ) , (LMN ,PR0G1) , ; 

I (UNSAT, (B9999)) , (BIAS,FA00) , (ABS) , (SL,9) 

1 (PERM) 

The JOB and LIMIT cards are the same in function as in previous 
examples. The options of the LOAD command require some definition. 
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(Note that a semicolon is the run-on indicator.) Here are the 

LOAD arguments which are required: 

EF: the element files (in parentheses, separated by 

commas) which are to be put together to make up the 
load module. In our example, only one file. (Omitted 
if a GO file is used - see BTM manual.) Names of 
element files must have 8 or fewer characters. 

LMN: the load module name, eight or fewer characters. 

UNSAT: list of accounts (in parentheses, separated by 

commas) from which unsatisfied references are to be 
picked up* The library of each account is accessed. 

The account with the dialogue macros (B9999 at Irvine) 
must be included. 

BIAS: the lower limit into which on-line user programs 

can be loaded in this installation — FAOO at Irvine; 
elsewhere, check with computer center personnel. 

ABS: specifies absolute load module. 

PERM: specifies that the file is to be permanently 

retained. 

Here are some LOAD arguments which are optional : 

MAP: produces a listing of the locations into which 

the element files and external references are loaded. 
Very useful in debugging the program. 

SL: specifies the error severity level that will be 

tolerated by the loader in forming a load module. The 
value may range from 0 through F. 



After the load module has been successfully generated, the 
programmer will want to run it. The procedure is: 

IRUN carriage return 

LOAD MODULE FID: PR0G1 carriage return 

;G (and a bell, if terminal has one) 



tion as ir previous (Here again the machine printout is underlined.) The programmer 

squire some definition. now has a choice: to begin the program execution he may hit the 



O 

ERIC 



54 



*54 



carriage return. If (as is often the case) the program still has 
errors , he may choose instead to use the DELTA facilities (explained 
in 3.4) to do some debugging or to set breakpoints for debugging 
at various points during execution. When he is ready to begin 
running the program, he types 

;G carriage return 

During the execution of the program, the user can always go into 
DELTA by pressing the escape key twice. When he is ready to 
proceed with the program he types 
;P 

to resume at the point he left (see 3.5 for variations) . If he 
has set breakpoints the program will automatically stop at those 
points, ready for DELTA commands. He can proceed with the running 
of the program as above. 

To stop the program before it finishes, the user can type STOP 
at any place where the program asks for an answer ; or he can at 
any point* hit 2 escapes twice in succession. This returns him to 
the Executive. 
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6. Sectioning a program 

Large programs preset some special problems. They may take a very 
long time to assemble, or even refuse to assemble at all!! This is 
not only expensive, it may also be inconvenient: at some installations 
any long job will b** held over and run at night. It is also easier to 
modify a program in many pieces. Thus the programmer may want to 
assemble his program in smaller pieces, reassembling them one at a 
time as errors are found. Some care must be taken to be sure that 
the relationship among the pieces or sections is made evident to the 
system. Each section must begin with 
SYSTEM DIALOG 

but only the first section (where the student begins the dialog) 
should have a NAME or START command. The last command to be executed 
in the program as a whole (not in each section) should be followed by 
a FINALE or STOP command. Each part other than the first section 
should end with 

END (no arguments) 

The first section should end with 
END DIALOGUE 



Any label which is referred to in one section and defined in another 
requires special treatment. If the two sections are called SOURCA 
and SOURCB, for instance,, and the label A33 is defined in SOURCA and 
referred to in SOURCB, then the command 
DEF A33 

must appear in SOURCA; and the command 
SREF A33 
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REF 



A33 
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roust appear in SOURCB. Any statement labels , or parameter names which 
are defined in one section and referred to in another require DEF 
statements (in the defining program) and SREF or REF statements (in 
the referring program) . These statements can occur anywhere in the 
program sections , but it is good practice to put them at the beginn- 
ing. All counters used must be defined in the first section , mentioned 
in a DEF statement in that section and in REF statements in other 
sections using the counter (s). Any SAVE COUNTER, ALL commands used 
in that section must be preceded by the COUNTER statement (s) . More 
than one symbol can be included in each DEF or SREF statement. For 
example , 

SREF A33,B1,B6,CC 

talers care of the three labels A33,B1,B6, and the counter CC. 

If ENTRY commands (for restart) are used in the second or other 
parts , ENTRY must also appear in the first section of the program, 
anywhere after the START or NAME command. In the other sections it 
can be used anywhere after the label to which the branch is made on 
entering that section. It is good practice to place it before a 
WRITE statement. 

When each partial program is debugged, a load module to be used by 
students might be generated by this job: 

! JOB (ACCOUNTING INFORMATION) 

1 LIMIT (TIME, 10) 

1L0AD (EF, (BINA) , (BINB) ) , (LMN,LESS0N1) , (PERM) , ; 

1 (BIAS,FA00) , (ABS) , (UNSAT, (B9999) ) , (SL,9) , (MAP) 
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Note that the binary file BINA and BINB must be assembled without 
the SD METASYM option. If the total program size is large, I OLAY 
may be used instead of 1 LOAD , with the same arguments. 

The following page shows an example of a pair of program sections 
with the control statements needed to get them assembled. 



gged, a load module to be used by 
is job: 

FORMATION) 

NB)) , (LMN,LESS0N1) , (PERM) ,; 

AT, (E9999) ) , (SL,9) , (MAP) 



5 ? 

ERIC 



58 



UOB PHYSICS , IRVINE , 2 
I LIMIT (TIME ,10) 

1 ASSIGN M:BO, (FILE,BINA) 
l METAS YM LS ,LO, SI ,BO/ AC (B9999 ) 



SYSTEM 


DIALOG 


NAME 


'EXAM' 


DEF 


CA , CM , AA , RDQ 


SREF 


B1,XYZ,TAB1,TAB2 


COUNTER 


(CA , CM , CTOT) 


etc. 




• • • 

EPILOG 




END 


DIALOGUE 



l JOB PHYSICS, IRVINE, 2 
1 LIMIT (TIME, 10) - 
! ASSIGN M:BO, (FILE,BINB) 

1 METAS YM LS ,LO,SI ,BO,AC (B9999) 





•SYSTEM 


DIALOG 




DEF 


B1 , XY2 , TABl , TAB2 




SREF 


CA,CM,AA,RDQ 


B1 


etc. 





END 




bS 



7. Overlaying 
The SIGMA 7 BTM u 
very well run int 
of it essential I) 
reorganize the pr 
core, and two or 
take turns occupy 
• overlaying 1 . Th 
related in time a 



The root should J - 
since no part of 
core. All counte 
so the loader wij 
access them by 

The • root 1 also 



The command: 

LOAD 

will cause the s^ 
into core, so th^ 
be followed by, 
to which the pro^ 
LOAD 

will cause BINA 
tion (in BINA, ul 
The root program! 
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7 . Overlaying 

Tns SIGMA 7 BTM user is allotted a limited amount of core , so he may 
very well run into tha situation where he las written more coding (all 
of it essential I) than can be accomodated. It is often possible to 
reorganize the program into a ’roof segment , which is always in 
core, and two or more other segments, (or groups of segments), which 
take turns occupying the remaining available space. This is called 
'overlaying'. The way in which the root and other segments are 
related in time and space is called the ’tree’ structure. 

The root should hold all information used by more than one segment, 
since no part of a segment is available for use when it is not in 
core. All counters should be defined in tha root segment and DEFed 
so the loader will make them available to the others, which will 
access them by using an SREF statement. 

The ’roof also contains the instructions for loading segments. 

The command: 

LOAD • BINA 1 

will cause the segment whose binary file is named BINA to be brought 
into core, so that the instructions in it can be executed. This must 
be followed by, or combined with, a branch to the location in BINA 
to which the programmer wants to transfer. 

LOAD 1 BINA • , BB1 

will cause BINA to be loaded into core, and will also set the instruc- 
tion (in BINA, usually) with label BB1 as the next one to be executed. 
The root program will have an 
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SREF BBl, 

and segment BINA will have a 
DEF BBl. 

An alternate form cf LOAD is TRANSFER. 

The tree structure must be described in the I TREE control command 
immediately following 10LAY or ! OVERLAY. The ’root* is the left- 
most segment in the command; from the root extend two or more 'paths* , 
each consisting of those segments that may occupy core storage (along 
with the root) at the same time. Suppose we have our program assembled 
as 4 binary files, with BROOT the name of the root segment, B1 the 
segment that is to be executed first, 32A and B2B two segments that 
are to be loaded together into the same space Bl occupies, B1 another 
segment that is to be loaded into that space. Then I TREE command 
would be: 

1 TREE BROOT- (3l , B2A-B2B , B3 ) 

The •-* indicates that the two named binaries cam be loaded next to 
each othery at the same time, incore, the # , # indicates that two 
segments, (or groups of segments), are to overlay one another (that 
is, begin at the same core storage location when loaded). The • () • 
indicates a new level of overlay. 

This tree statement says that at any given time ve may have one of 
three different 'packages' in core storage: 

1) BROOT and Bl 

2) BROOT, B2A and B2B 

3) BROOT and B3 



O 
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When a segment is not in 
be referenced only by fi 
always in core , it is us 
are not in core simultar 



The root segment would i 



SYSTEM 


DIA 


NAME 


'Rl 


SREF 


BU: 


DEF 


R2, 


COUNTER 


(c; 


WrITE 


•ti 


WRITE 


•LE 


LOAD 


' B2 



R2 


WRITE 


'Ll 




LOAD 


*b: 



LOAD ' B; 

etc. 



STOP 

END 

The source file for 
SYSTEM 
SREF 
DEF 



DU 



Bl 
D1 
R2 1 
BlI 
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Cl 



l 



When a segment is not in core it is on disk, and anything in it can 
be referenced only by first loading it into core* Since BROOT is 
always in core, it is used for communication between sections which 
are not in core simultaneously. 



The root segment would include: 



he 1TREE control command 


SYSTEM 


DIALOG 




The 'root' is the left- 


NAME 


* RTEX ' 




t extend two or more 'paths'. 


SREF 


BlENT , B2ENT , 3 3 ENT 




y occupy core storage (along 


DEF 


R2 , CADD . CMULT , CEXP , R4 , R5 




■ we have our program assembled 


COUNTER 


( CADD , CMULT , CTOT , CEXP , CD ) 




the root segment, Bl the 


WrITE 


’THIS IS At REVIEW OF COMPLEX 


NUMBERS . 1 


and B2B two segments that 


WRITE 


’ LET * * S TRY ADDITION FIRST.’ 




pace Bl occupies , Bl another 


LOAD 


’Bl’ , BlENT 


(load ,file Bl and 


ace. Then ITREE command 






start with the command 
labelled BlENT) 




R2 WRITE 


’LET’ ’ S TRY MULTIPLICATION’ 


(return from Bl) 


ries cam be loaded next to 


LOAD 


•B2A’ 


(load B2A but do not 
branch) 


e ' , 1 indicates that two 


LOAD 


*B2B,B2ENT 


(load B2B and branch) 


overlay one smother (that 


etc. 






on when loaded) • The • () * 


• • • 








STOP 








END 


DIALOGUE 





en time we may have one of 

The source file for B1 would include 

DIALOG 
R2,CADD 
BlENT 



SYSTEM 

SREF 

DEF 
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B1ENT 



etc. 



8 . Student use 



TO R2 (return to root) 

END 



Similarly, each of the segments would contain SREFs for each of the 
labels and counters in the root to which it referred and DEFs for 
each of its symbols to which the root aegment might refer. B2A and 
B2B must also, of course, contain DEF and SREF statements to define 
internal references between them. 

The job cards for creating the load module COMP from these binary 
files would be: 

I JOB (ACCOUNTING INFORMATION) 

! LIMIT (TIME, 10) 

IOVERLAY (EF, (BROOT) , (Bl) , (B2A) , (B2B) , (B3) ) , ? 

! (MAP) , (PERM) , (SL, 9) , (LMN,COMP) ,; 

I (SEG) , (UNSAT, (B9999) ) , (ABS) , (BIAS,FA00) 

I TREE ROOT- (Bl ,B2A-B2B,B3) 



As indicated in 3.5, t 
program by means of th 



j_RUN 

LOAD MODULE 
?G 

The student must be to 
the program and ?G. 



When the student first 
identification if the 
is used for restarting 
dialogue at a single s 



When the student wants 
usual procedure of pre 
input, the word STOP, 
allows restart, he is 
neirt time to tries this 



Here B9999 is the account in which the system library is stored, and 
FA00 is the lower limit of core storage for the program, which is a 
system parameter, and may differ in other installations. The command 
IOLAY could be used in place of IOVERLAY, with the same arguments. 



Because the use of the 
non-programmers, at Irv 
for calling dialogues, 
types PI; then he types 
No error messages or br 
records of dialog usage 
this may not be possibl 
with considerable force 



8. Student Use 



) 

\ 

ain SREFs for each of the 
t referred and DEFs for 
ent might refer. B2A and 
SREF statements to define 

COMP from these binary 



(B2B) , (B3) ) ,? 

J 

\S,FA00) 

tem library is stored, and 
r the program, which is a 
installations. The command 
tfith the same arguments. 



As indicated in 3.5, the students can use the conversational 
program by means of the RUN facility: 

JRUN 

LOAD MODULE FID: PR0G1 

;G 

The student must be told how to sign on, to type RU, the name of 
the program and ;G. 

When the student first enters the program, he is asked to type an 
identification if the restart facility is used. This identification 
is used for restarting purposes if the student does not complete the 
dialogue at a single sitting. 

When the student wants to leave the terminal, he can follow the 
usual procedure of pressing Escape twice? or, he can type, at any 
input, the word STOP. If he enters STOP and if the program 
allows restart, he is reminded to use the same identification the 
next time to tries this dialogue. 

Because the use of the RUN facility appears somewhat awkward to 
non-programmers, at Irvine we have installed a special subsystem 
for calling dialogue. At. the prompt character (I) the student 
types DI? then he types the name of tne dialogue he wishes to use. 

No error messages or break messages are sent to the student, and 
records of dialog usage are maintained. (At other installations, 
this may not be possible? system modifications are often resisted 
with considerable force.) 





APPENDIX 1: EXAMPLES 



2. Loading and running ; 



1. Creating a binary file 



-'EDIT 

♦EDIT EXAf-’.D 

*TY 1-25 * (type the symbolic file 

1.235 ; 30B PCDPCCv6, ANNA,2 previously entered) 

2. 023 I LIMIT (TIKE, 5) 

3 .CT.O .'ASSIGN fl:SO, ( filE.EXakpso) (binary file to be called 

4.000 IPiETASYFl SO, SI, 80, AC ( 89999 ) EXAMPBO) 



5.333 




SYSTEM 


DIALOG 


6.03'.; 




EXAMPLE 


OF A DIALOGUE PROGRAM 


7 




riAHE 


•EXAM* 






CCUrjTER 


COUNT 




A1 


write 


'-.HAT IS 4 X 5?' 


15.C30 




BUilP 


COUNT 


11.533 




irjPUT 




12*533 




JtF 


'20', A2 


13.530 




IF 


•9', A3 


14 .coa 




OTHER 


A7 


15*550 


A3 


TO 


AS, (COUNT, 3) 


16*07-0 


A6 


WRITE 


•YOU "RE ADDING. TRY AGAIN.' 


17,000 




TO • 


A1 


ia.0u£ 


A7 


TO 


AS, (COUNT, GE, 3) 


19. COO 




WRITE 


'TRY AGAIN.' 






TO 


A1 


21.000 


AS 


WRITE 


•4 X S = 2(5' 


22. oho 




TO 


A8 


23.000 


A2 


WRITE 


•GOOD.’ 


24*000 


A8 ' 


EPILOG 




25.000 




END 


DIALOGUE 



*£•“'0 



IASSISN P!rSI,(FILE,EXAnp) 
IBP.T 

INSERT 308? Y 

YOUR nAXl.W PRI0RITY= 2 

EDIT? 

3C-8 tr.SERTEO. ID=9 
SATUS C.-.ECK? Y 
1 0=9 

Rw'iN Ir«u . 

10=9 

PUNNING. 

10=9 



(assign the symbolic file to 
system input) 

(call bat.oh system) 

(user enters Y for yes) 

(user enters N for no) 

(user enters Y for yes. Status 

may be waiting, running, or 
completed) 



IL3A0 

ELEMENT FILLS: EXAfiPOO 
0PTIC.'!G: P,U(B399=) 

F: 

Scv/.LEV. = 3 

>■: NO UNDEFINED INTERNALS 

;c 

UHAT IS 4 X 5? 

?9 

YOU'RE ADDING. TRY AGAIN. 
UHAT IS 4 X 5? 

?20 

coco. 

YOU HflUE COMPLETED THIS PROCfj 
P LEASE TYPE ANY COMMENTS AND] 
?N0 comment 



THANK YOU 

XIT AT JRSU1+.90 
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2. Loading and running a binary file 



[pe the symbolic file 
.viously entered) 

[nary file to be called 
UdPBO) 



UN. 



Assign the symbolic file to 
system input) 

:all batofc system) 
jser enters Y for yes) 

iser enters N for no) 



iser enters Y for yes. Status 
nay be waiting, running, or 
completed) 



IL3A0 

ELEMENT FILLS: EX AMP 00 
OPTIC.'! 15: t\u(G?09-) 

r: 

SEt.LEV. = 3 

>:*r NO UNDEFINED INTERNALS *t 
;C 

UHAT IS 4 X 5? 

?9 

YOU'RE ADDING. TRY AGAIN. 
iiJHAT IS 4 X 5? 

?2 : j 

GOOD. 

YOU haue cohpleteo this program. 

PLEASE TYPE ANY COMMENTS AND SUGGESTIONS. 
?N0 CONK, ENT * ' * 

THANK YOU 

XIT AT 5*SU1+.90 

I 
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(Load EXAMPBO, created above) 
(D for Delta; U(B9999) defines 

appropriate library) 

« 



(entered by user to start pro- 
gram operation) 

(beginning of the conversational 
dialogue) 



3. Creating a Load Module 



4* Using a FORTRAN i 




In this example, control information is typed directly and is not 
part of the EXAMP symbolic file, as it was in 1. Note that the SD 
option must not be used on the M2TASYM card in making the load 
module* 



1EDIT 

fv <•••:.* 

: CE 1 — £ Delete control cob-a&nds from 

^ EXAMP file* 

! 1 - 1 Cancel any previous assignments* 



INSERT 002 7 Y 

YOUR MAXIMUM PRIORITY^ 2 

1 



: !00B PCDP5>G6, ARMA, 2 
2 

riLiniT (rinE,s) 

3 

: IASSIGN MjSI , (FILE, EXAFIP) 

4 

5 lASSIGfJ M:80, (FILE,EXAFiPBO) 
5 

jiriETASY n LS, SI ,80, AC (99999 ) 



: JLOAD (im, EXANPOI ), (PERA), (BIAS, FA00), (A 8 S)’, (UNSAT, (89999) ), ,* 



: ! (EF, (EXARPBO ) ) 
8 



(EXAMPDI vill be name of load 
module) 



EOIT? U 

JOQ INSERTED* 10=35 
STATUS CHECK? Y 
ID“35 

1 AHEAD 



r/s':;v;z. 

10=35 

ruling- 

10=35 

completed. 

ID= 

ICET RUN Special command for Irvine system; 

usually !RUN is the command used 
LOAD rODULE FIDtEXAMPDI to load EXAMPDI 

;C 

!*>AT IS 4 x 5? (beginning of conversational 

? dialog) 



6 ? 



!E0IT 

*E0IT F0RP10T 

*ty 1-13 

i.cr.o nos p.iYsics.ip.v 
2.003 iLlfilT (ti;;f, 5) 
3. 3D? ! ASSIGN f'*:B0,(FI 
IFORTRAN SI, 80, l 
SU3R0UTI:.'C 



4.333 

S.003 

6.320 

7.3C0 

8.033 

9.330 

13.333 



DIMENSION 
00 1 1=1,2 
x(i:-si:j(i 

RETURN 
END 



IASSIGN FI : S 1 , ( FILE, F0RPLC 

lepn 

INSERT 300? Y 
your r’-Axinun priority= 2 
EDIT? fj\ 

JOB INSERTED. I0=AS 
STATUS CHECK? N 



l EDIT 

*£0IT F0RPL0TT 
♦SE1-1S;/G3/S/20/;TY 
— C2:N0 SUCH STRG 

1.033 1308 PHYSICS, IRV 
2.030 ILIHIT (TI"E,13)| 
3.303 IASSIGN /n:B 0 , (Fll 



4.000 


INETASm SI, 00 , 1 


5.030 


'' 


SYSTEfl 


6.033 




START 


7.320 




REF 


8. 220 


AA 


L^ITE 


9.000 


C3 


FOPTRAr 


12.032 


cc 


PLOT 


11.222 




STOP 


12.033 


X 


RES 


13.000 




ENO 


•EOF HIT 


after 


13. 



Using a FORTRAN Subroutine 



directly and is not 
1. Note that the SD 
making the load 



|e control commands from 
file. 

ll any previous assignments. 



\ 



JEOIT 

*EDIT FORPLOT 
*TY 1-15 

I.O'.iS 1308 P..YSICS, IRVINE, 2 
2.00-5 ILIRIT (ti;;f,5) 

3.000 ! ASSIGN ri:BC, (FILE, VALUES) 

4.003 ! FORTRAN SI,B0,LS,LO 
S.50* SUSROUTir.'E VALUES(X) 

6.000 DIMENSION X(1C0) 

7.000 * 00 1 1=1,20 

e.roo i x(i;-si:.'(i/3. ) 

9.000 RETURN 

10.303 END 

* 

IASSIGN FI : S I , ( FILE , FORPLOT ) 



i^pn 

INSERT 308? Y 

YOUR r’^Xinun PRIORITY 3 

EOIT? tr\ 

308 INSERTED. I0=4S 
STATUS CHECK-? » 



(89999 ) ; 

?DI will be name of load 
Ills) 



Lai command for Irvine system; 
Lly !RUN is the command used 
bad EXAMPDI 



I EOIT \ 

*EOIT FORPLOTT \ 
♦SE1-1S;/63/S/20/;TY 
— C2:N0 SUCH STRG 

1.303 1308 PHYSICS, IRVINE, 2 

2.303 I LIMIT (|TI"E,19) 



3.050 


IASSIGN /n:E0, (FILE, F0R30) 


4.030 


mcrAsrri 


SI, 30,L0,AC( 39999) 


5.333 


/ 


SYSTER 


DIALOG 


6.353 




START 




7.333 




REF 


VALUES 


8.350 


AA 


WRITE 


'TEST OF PLOT 


9.053 


C3 


FORTRAN 


VALUES, X 


15.050 CC 


PLOT 


X,23 


11.055 




STOP 




12.503 


X 


RES 


133 


13.533 




EfiO 


DIALOGUE 



—EOF HIT AFTER 13. 
c 



boning of conversational 
tog) 



File FORPLOT contains a FORTRAN 
subroutine, VALUES OO 



Compiling the subroutine 



(FORPLOTT is a DIALOG program 
which calls VALUES. 

Modifying the program. 



Line 9 will call the FORTRAN 
PROGRAM 




4 
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Using FORTRAN Subroutines (Cont.) 



ussiGrj n:Si, (file.forplott ) 
!3P" 

INSERT SOB? Y 

YCUB HAXI."U~ PRI0RITY= 2 

EDIT? TJ 

303 INSERTED. 10=47 
STATUS CHECK? Y 
1 0=47 

UAITIKG: 8 AHEAD 
CURRENT 10: 39 
1 0=47 

WAITING: 8 AHEAD 
CURRENT ID: 39 
ID=47 

UAITIMG: 8 AHEAD 
cur.RErrr 10: 39 
ID=47 

CC.PLETED. 

ID= 



ILOAD 

ELERENT FILES: F0F8D, VALUES 
OPTIONS: U(B9999) 

F: 



Assemble FORTRAN routine. 
Two alt inodes to return to 
executive level. 



Both binary outputs now 
available. 



Run program on line. 

Name both binary files. 

Look for unsatisfied library 
references in account B9999. 



SEV.LEV. = 0 
XEQ? Y 



T says ’Proceed with execution* . 



TEST OF PLOT 

-5.9990 DIN HORIZONTAL 



* 



* 



* 



* 



* . 



* 



* 



USER EXIT. 

I 



RAX 



* 



0.9954 

* 



* 




* 
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Die FORTRAN routine, 
lit modes to return to 
Itive level* 



) inary outputs now 
(able* 



program on line* 

(both binary files. 

I for unsatisfied library 
perences in account B9999* 



ps ’Proceed with execution’ . 



APPENDIX 2: REFERENCES 

XDS SIQIA Symbol and Metasymbol - 900952 
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APPENDIX 3: A FINAL WORD (OR TWO) TO THE READER 



* Comments on this manual, noting errors, omissions, and 

ambiguities will be appreciated, % 

* Copies of the system tape are available to those with 
SIGMA 7s who would like to try using it. Please enclose 
blank tape with. your request. 

* Those who are actively engaged in writing dialogs are 
asked to inform us of this fact so that we can keep them 
up-to-date on changes to the system as they occur. 

Such changes tend to be relatively minor and will be of 
small interest to any expect those actually using the 
system. Let us know the date of the latest modification 
you have . 

* Dialpgs which have been developed using this system are 
also availablecto potential users. Information will be 
sent on request. 

* Reports of system errors or failures should be reported 
in detail, with copies of input and output, if possible. 

* All such comments, requests, reports, and notifications 
should be addressed to: 

Alfred M. Bork 

physics Computer Development Project 
University of California, Irvine 
Irvine, California 92664 
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